Updates to Bootstrap 5 and adds theme support for code coverage. by gammamatrix · Pull Request #1036 · sebastianbergmann/php-code-coverage

gammamatrix · 2024-05-07T05:05:43Z

Changes

Upgrades Bootstrap to v5.3.3
Upgrades jQuery v3.7.1
Allows themes using Bootstrap CSS Variables
popovers still supported.

Assets

I used these from jsdeliver and Cloudflare:

Theme support

Bootstrap 5.3 comes with dark and light mode support.

The <html> tag of each top level webpage gets a new element:

<html lang="en" data-bs-theme="dark">

Propose new theme variable in code coverage section:

<html lang="en" data-bs-theme="{{theme}}">

For example: src/Report/Html/Renderer/Template/directory.html.dist

This custom theme file provides some simple examples, the colors are not perfect, but good enough to test the code.

I put these themes into customCssFile="./phpunit-themes.css"

Example phpunit-themes.css for customCssFile

[data-bs-theme="lavender"] {
    color-scheme: lavender;
    --bs-body-color: #483d8b;
    --bs-body-color-rgb: 72, 61, 139;
    --bs-body-bg: #d8bfd8;
    --bs-body-bg-rgb: 216, 191, 216;
    --bs-emphasis-color: #fff;
    --bs-emphasis-color-rgb: 255, 255, 255;
    --bs-secondary-color: rgba(222, 226, 230, 0.75);
    --bs-secondary-color-rgb: 222, 226, 230;
    --bs-secondary-bg: #343a40;
    --bs-secondary-bg-rgb: 52, 58, 64;
    --bs-tertiary-color: rgba(222, 226, 230, 0.5);
    --bs-tertiary-color-rgb: 222, 226, 230;
    --bs-tertiary-bg: #483D8B;
    --bs-tertiary-bg-rgb: 72, 61, 139;
}

[data-bs-theme="blue"] {
    color-scheme: blue;
    --bs-body-color: #2F4F4F;
    --bs-body-color-rgb: 47, 79, 79;
    --bs-body-bg: #1E90FF;
    --bs-body-bg-rgb: 30, 144, 255;
    --bs-emphasis-color: #fff;
    --bs-emphasis-color-rgb: 255, 255, 255;
    --bs-secondary-color: #DCDCDC;
    --bs-secondary-color-rgb: 220, 220, 220;
    --bs-secondary-bg: #64daed;
    --bs-secondary-bg-rgb: 100, 218, 237;
    --bs-tertiary-color: rgba(222, 226, 230, 0.5);
    --bs-tertiary-color-rgb: 222, 226, 230;
    --bs-tertiary-bg: #00BFFF;
    --bs-tertiary-bg-rgb: 0, 191, 255;
}

[data-bs-theme="wheat"] {
    color-scheme: wheat;
    --bs-body-color: #2f4f4f;
    --bs-body-color-rgb: 47, 79, 79;
    --bs-border-color: #2f4f4f;
    --bs-border-color-translucent: rgba(47, 79, 79, 0.175);
    --bs-body-bg: #f5deb3;
    --bs-body-bg-rgb: rgba(245, 222, 179, 50);
    --bs-emphasis-color: #3f2f4f;
    --bs-emphasis-color-rgb: 63, 47, 79;
    --bs-secondary-color: rgba(63, 79, 47, 0.75);
    --bs-secondary-color-rgb: 63, 79, 47;
    --bs-secondary-bg: #f5b3eb;
    --bs-secondary-bg-rgb: 245, 179, 235;
    --bs-tertiary-color: rgba(222, 226, 230, 0.5);
    --bs-tertiary-color-rgb: 222, 226, 230;
    --bs-tertiary-bg: #b3f5bd;
    --bs-tertiary-bg-rgb: 179, 245, 189;
}

[data-bs-theme="pepper"] {
    color-scheme: pepper;
    --bs-body-color: #2F4F4F;
    --bs-body-color-rgb: 47, 79, 79;
    --bs-body-bg: #cd5c5c;
    --bs-body-bg-rgb: 205, 92, 92;
    --bs-emphasis-color: #fff;
    --bs-emphasis-color-rgb: 255, 255, 255;
    --bs-secondary-color: rgba(222, 226, 230, 0.75);
    --bs-secondary-color-rgb: 222, 226, 230;
    --bs-secondary-bg: #5ccdcd;
    --bs-secondary-bg-rgb: 92, 205, 205;
    --bs-tertiary-color: rgba(222, 226, 230, 0.5);
    --bs-tertiary-color-rgb: 222, 226, 230;
    --bs-tertiary-bg: #8FBC8F;
    --bs-tertiary-bg-rgb: 143, 188, 143;
}

phpunit.xml changes

<coverage
    includeUncoveredFiles="true"
    pathCoverage="false"
    ignoreDeprecatedCodeUnits="true"
    disableCodeCoverageIgnore="true">
    <report>
        <clover outputFile="output/clover.xml" />
        <cobertura outputFile="output/cobertura.xml" />
        <crap4j outputFile="output/crap4j.xml" threshold="50" />
        <html outputDirectory="output/html" lowUpperBound="50" highLowerBound="90" customCssFile="./phpunit-themes.css" />
        <php outputFile="output/coverage.php" />
        <text outputFile="output/coverage.txt" showUncoveredFiles="false" showOnlySummary="true" />
        <xml outputDirectory="output/xml" />
    </report>
</coverage>

Proposed theme variable:

<html outputDirectory="output/html" lowUpperBound="50" highLowerBound="90" customCssFile="./phpunit-themes.css" theme="dark" />

CSS Variables in style.css

I had to slightly adjust the existing CSS rules, such as adding a td to increase override priority from the Bootstrap 5 rules.

See src/Report/Html/Renderer/Template/css/style.css

These new default rules should be compatible across other themes.

Here are few I updated, but did not finalize:

The alpha value could be adjusted for the different rules.

.table tbody tr.covered-by-large-tests td, li.covered-by-large-tests, tr.success, td.success, li.success, span.success {
 background-color: {{success-low}};
 /* background-color: rgb(from var(--bs-success) r g b / 0.25); */
}

.table tbody tr.covered-by-medium-tests td, li.covered-by-medium-tests {
 background-color: {{success-medium}};
 /* background-color: rgb(from var(--bs-success) r g b / 0.5); */
}

.table tbody tr.covered-by-small-tests td, li.covered-by-small-tests {
 background-color: {{success-high}};
 /* background-color: rgb(from var(--bs-success) r g b / 0.75); */
}

.table tbody tr.warning td, .table tbody td.warning, li.warning, span.warning {
 background-color: {{warning}};
 /* background-color: rgb(from var(--bs-warning) r g b / 0.25); */
}

.table tbody tr.danger td, .table tbody td.danger, li.danger, span.danger {
 background-color: {{danger}};
 /* background-color: rgb(from var(--bs-danger) r g b / 0.25); */
}

.table tbody td.info {
 /* background-color: #d9edf7; */
 /* background-color: var(--bs-info-bg-subtle); */
 background-color: rgb(from var(--bs-info) r g b / 0.25);
}

Dev Notes

Testing themes

Here is a screenshot of testing the example themes in: phpunit-themes.css

You can inspect the DOM to manually change

<html lang="en" data-bs-theme="">
<html lang="en" data-bs-theme="dark">
<html lang="en" data-bs-theme="lavender">
<html lang="en" data-bs-theme="wheat">
<html lang="en" data-bs-theme="blue">
<html lang="en" data-bs-theme="light">

The theme value would get set via phpunit.xml. Optionally, javascript theme switching can be added to the page, but that might be too crude.

Tech Debt

There are a few other things that are a bit out of date.

NOTE: I think these fixes are beyond the scope of this PR and I would not mind tackling those after this:

The d3 library for charts on the dashboard.
There are a few HTML tags that have been deprecated, such as align="center".
If these changes were made, the git diff would be huge.

…pdate for test EndToEndTest::testPathCoverageForBankAccountTest

gammamatrix · 2024-05-07T20:19:47Z


 </tbody>
 </table>
-%a


Not sure if this is correct way to fix this test by adding the footer.

… for BankAccount.php_path.html.

gammamatrix · 2024-05-07T22:20:24Z

Should I create another Pull Request, in PHPUnit, to add a theme variable to phpunit.xsd?

<xs:complexType name="coverageReportHtmlType">
    <xs:attribute name="outputDirectory" type="xs:anyURI" use="required"/>
    <xs:attribute name="lowUpperBound" type="xs:integer" default="50"/>
    <xs:attribute name="highLowerBound" type="xs:integer" default="90"/>
    <xs:attribute name="colorSuccessLow" type="xs:string" default="#dff0d8"/>
    <xs:attribute name="colorSuccessMedium" type="xs:string" default="#c3e3b5"/>
    <xs:attribute name="colorSuccessHigh" type="xs:string" default="#99cb84"/>
    <xs:attribute name="colorWarning" type="xs:string" default="#fcf8e3"/>
    <xs:attribute name="colorDanger" type="xs:string" default="#f2dede"/>
    <xs:attribute name="customCssFile" type="xs:string"/>
    <xs:attribute name="theme" type="xs:string" default=""/>
</xs:complexType>

The colors for low, medium, high, warning, and danger can be controlled by setting the CSS Variables:

.table tbody tr.covered-by-large-tests td, li.covered-by-large-tests, tr.success, td.success, li.success, span.success {
  background-color: {{success-low}};
  /* background-color: rgb(from var(--bs-success) r g b / 0.25); */
}

Variable	CSS
colorSuccessLow	`rgb(from var(--bs-success) r g b / 0.25)`
colorSuccessMedium	`rgb(from var(--bs-success) r g b / 0.5)`
colorSuccessHigh	`rgb(from var(--bs-success) r g b / 0.75)`
colorWarning	`rgb(from var(--bs-warning) r g b / 0.25)`
colorDanger	`rgb(from var(--bs-danger) r g b / 0.25)`

Using these rules make it safe between switching themes and the colors will match the Bootstrap Progress Bar and Popovers.

The Bootstrap CSS Variables may be overridden in a theme defined with the existing:

customCssFile="./phpunit-themes.css"

NOTE: The CSS rules defined in style.css may still be overridden in customCssFile.

.table tbody tr.covered-by-large-tests td, li.covered-by-large-tests, tr.success, td.success, li.success, span.success {
  background-color: var(--bs-teal);
}

I tested passing both overriding with the customCssFile and in overriding the colors with CSS variables in the phpunit.xml configuration as well and both work fine.

The custom rules in customCssFile may override the colors defined phpunit.xml.

colors

<html
    outputDirectory="output/html"
    lowUpperBound="50"
    highLowerBound="90"
    customCssFile="./phpunit-themes.css"
    colorSuccessLow="rgb(from var(--bs-purple) r g b / 0.75)"
    colorSuccessMedium="rgb(from var(--bs-blue) r g b / 0.55)"
    colorSuccessHigh="rgb(from var(--bs-teal) r g b / 0.25)"
    colorWarning="rgb(from var(--bs-warning) r g b / 0.25)"
    colorDanger="rgb(from var(--bs-danger) r g b / 0.25)"
    theme="dark" />

And with these custom CSS rules:

.table tbody tr.covered-by-medium-tests td, li.covered-by-medium-tests {
    background-color: purple;
}

.table tbody tr.covered-by-large-tests td, li.covered-by-large-tests, tr.success, td.success, li.success, span.success {
    background-color: aquamarine;
}

.table tbody tr.danger td, .table tbody td.danger, li.danger, span.danger {
    background-color: wheat;
}


.table tbody tr.covered-by-large-tests td, li.covered-by-large-tests, tr.success, td.success, li.success, span.success {
    background-color: aquamarine;
}

.table tbody tr.covered-by-medium-tests td, li.covered-by-medium-tests {
    background-color: purple;
}

.table tbody tr.covered-by-small-tests td, li.covered-by-small-tests {
    background-color: var(--bs-teal);
}

.table tbody tr.warning td, .table tbody td.warning, li.warning, span.warning {
    background-color: var(--bs-yellow);
}

.table tbody tr.danger td, .table tbody td.danger, li.danger, span.danger {
    background-color: crimson;
}

.covered-by-small-tests, tr.covered-by-small-tests td {
    background-color: var(--bs-teal);
}

.covered-by-medium-tests, tr.covered-by-medium-tests td {
    background-color: purple;
}

.covered-by-large-tests, tr.covered-by-large-tests td {
    background-color: aquamarine;
}

.not-covered, tr.not-covered td {
    background-color: crimson;
}

.not-coverable, tr.not-coverable td {
    background-color: var(--bs-yellow);
}

…mpatibility.

- See sebastianbergmann/php-code-coverage#1036

staabm · 2024-05-08T07:20:44Z

I wonder whether we need this new theme configuration, or whether it would be enough to use coverageHtmlCustomCssFile to define custom css-variable values and reduce the PR to just adding css-variables?

gammamatrix · 2024-05-08T14:22:34Z

I wonder whether we need this new theme configuration, or whether it would be enough to use coverageHtmlCustomCssFile to define custom css-variable values and reduce the PR to just adding css-variables?

The main reason why the theme configuration is required is so you can select the dark theme, which is provided in Bootstrap 5.

<html
    outputDirectory="output/html"
    lowUpperBound="50"
    highLowerBound="90"
    theme="dark" />

Just adding theme="dark" would enable dark mode.

I added some more information on the changes needed for the phpunit.xsd in sebastianbergmann/phpunit#5833

sebastianbergmann · 2024-05-11T08:59:59Z

Please split this into two pull requests: one for the Bootstrap update and one for the functional changes.

gammamatrix · 2024-05-12T01:07:31Z

Please split this into two pull requests: one for the Bootstrap update and one for the functional changes.

Here are the Bootstrap-only changes, for src and tests:

Bootstrap 5 upgrade without theme feature. #1037

FYI:

The only code I changed, besides removing the theme feature, was lightening up the alpha filtering to match the previous colors:

final class Colors
{
    private readonly string $successLow;
    private readonly string $successMedium;
    private readonly string $successHigh;
    private readonly string $warning;
    private readonly string $danger;

    public static function default(): self
    {
        return new self(
            'rgb(from var(--bs-success) r g b / 0.1)',
            'rgb(from var(--bs-success) r g b / 0.33)',
            'rgb(from var(--bs-success) r g b / 0.67)',
            'rgb(from var(--bs-warning) r g b / 0.1)',
            'rgb(from var(--bs-danger) r g b / 0.1)',
        );
    }

low was 0.25 and is now 0.1
medium was 0.5 and is now 0.33
high was 0.75 and is now 0.67
warning was 0.25 and is now 0.1
danger was 0.25 and is now 0.1

You can still test dark mode on generated code coverage by editing the HTML tag:

<html lang="en" data-bs-theme="dark">

gammamatrix · 2024-08-09T06:04:13Z

FYI: I just tried running the tests, my installation is on PHPUnit 11.3.0 and I did not see the whitespace error.

I did confirm the test testPathCoverageForBankAccountTest ran with team city. I will test it a bit more to make sure I am actually testing what I am expecting.

➜  php-code-coverage git:(main) vendor/bin/phpunit --coverage-text
PHPUnit 11.3.0 by Sebastian Bergmann and contributors.

Runtime:       PHP 8.2.10 with Xdebug 3.3.1
Configuration: playground-directory/vendor/phpunit/php-code-coverage/phpunit.xml

SSSSSSSSSSSSSSSSSSS............................................  63 / 122 ( 51%)
...........................................................     122 / 122 (100%)

Time: 00:02.056, Memory: 20.00 MB

OK, but some tests were skipped!
Tests: 122, Assertions: 333, Skipped: 19.


Code Coverage Report:
  2024-08-09 05:57:18

 Summary:
  Classes: 21.74% (15/69)
  Methods: 61.45% (263/428)
  Lines:   85.06% (3222/3788)

sebastianbergmann · 2024-08-09T06:57:08Z

My last test (#1037 (comment)) was with the other PR (#1037). Can you please test with that, too? Thanks!

gammamatrix · 2025-10-19T02:22:34Z

@sebastianbergmann Should we close this PR?

I would still be willing to add an option to enable themes to add dark mode: Adds theme support to code coverage. phpunit#5833
If you do not want to add the full themes, we could at least add a boolean toggle for dark mode?

sebastianbergmann · 2025-10-19T04:57:06Z

Support for light/dark mode was implemented in #1095.

gammamatrix added 2 commits May 6, 2024 21:19

Updates to Bootstrap 5 and adds theme support for code coverage.

3a66772

Renames data-placement to data-bs-placemnet for Bootstrap 5. Footer u…

71d780a

…pdate for test EndToEndTest::testPathCoverageForBankAccountTest

gammamatrix commented May 7, 2024

View reviewed changes

Added missing bootstrap.bundle.min.js and removed changes to the test…

50b18d3

… for BankAccount.php_path.html.

gammamatrix added 2 commits May 7, 2024 15:38

Replaced sr-only with visually-hidden for the Bootstrap 5 upgrade.

02967da

Restored color variable options to style.css to maintain backwards co…

ba3047f

…mpatibility.

gammamatrix added a commit to gammamatrix/phpunit that referenced this pull request May 8, 2024

Adds theme support to code coverage.

36bbd10

- See sebastianbergmann/php-code-coverage#1036

gammamatrix mentioned this pull request May 8, 2024

Adds theme support to code coverage. sebastianbergmann/phpunit#5833

Closed

gammamatrix added a commit to gammamatrix/php-code-coverage that referenced this pull request May 11, 2024

sebastianbergmannGH-1036 - Bootstrap 5 upgrade without theme feature.

44a5185

gammamatrix mentioned this pull request May 11, 2024

Bootstrap 5 upgrade without theme feature. #1037

Merged

sebastianbergmann pushed a commit to gammamatrix/php-code-coverage that referenced this pull request Jul 25, 2024

sebastianbergmannGH-1036 - Bootstrap 5 upgrade without theme feature.

b762923

sebastianbergmann pushed a commit to gammamatrix/php-code-coverage that referenced this pull request Sep 5, 2024

sebastianbergmannGH-1036 - Bootstrap 5 upgrade without theme feature.

e967ff6

sebastianbergmann closed this Oct 19, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Updates to Bootstrap 5 and adds theme support for code coverage.#1036

Updates to Bootstrap 5 and adds theme support for code coverage.#1036
gammamatrix wants to merge 5 commits intosebastianbergmann:mainfrom
gammamatrix:update-to-bootstrap-5

gammamatrix commented May 7, 2024 •

edited

Loading

Uh oh!

gammamatrix May 7, 2024

Uh oh!

gammamatrix commented May 7, 2024 •

edited

Loading

Uh oh!

staabm commented May 8, 2024

Uh oh!

gammamatrix commented May 8, 2024 •

edited

Loading

Uh oh!

sebastianbergmann commented May 11, 2024

Uh oh!

gammamatrix commented May 12, 2024

Uh oh!

gammamatrix commented Aug 9, 2024

Uh oh!

sebastianbergmann commented Aug 9, 2024

Uh oh!

gammamatrix commented Oct 19, 2025 •

edited

Loading

Uh oh!

sebastianbergmann commented Oct 19, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

gammamatrix commented May 7, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Assets

Theme support

phpunit.xml changes

Proposed theme variable:

CSS Variables in style.css

Dev Notes

Testing themes

Tech Debt

Uh oh!

gammamatrix May 7, 2024

Choose a reason for hiding this comment

Uh oh!

gammamatrix commented May 7, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

staabm commented May 8, 2024

Uh oh!

gammamatrix commented May 8, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sebastianbergmann commented May 11, 2024

Uh oh!

gammamatrix commented May 12, 2024

Uh oh!

gammamatrix commented Aug 9, 2024

Uh oh!

sebastianbergmann commented Aug 9, 2024

Uh oh!

gammamatrix commented Oct 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sebastianbergmann commented Oct 19, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

gammamatrix commented May 7, 2024 •

edited

Loading

gammamatrix commented May 7, 2024 •

edited

Loading

gammamatrix commented May 8, 2024 •

edited

Loading

gammamatrix commented Oct 19, 2025 •

edited

Loading